home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Workbench Design
/
WB Collection.iso
/
workbench werkzeuge
/
icon tools
/
tooltype
/
tooltype.guide
(
.txt
)
< prev
next >
Wrap
Amigaguide Document
|
1996-04-07
|
13KB
|
300 lines
@database ToolType.guide
@master ToolType.guide
@$VER: 3.1
@author "Michael J Barsoom"
@(c) "1994 by Michael J Barsoom"
@index HeddleyAutoIndex
@remark Created with Heddley v1.1 (c) Edd Dumbill 1994
@node "MAIN" "ToolType documentation"
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
ToolType Release 3.1
Copyright
1993,1994 by Michael Barsoom
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Icon tooltype editor.
@{"
License
Disclaimer
" link "License_&_Disclaimer" 0} Legal Issues
@{"
Introduction
" link "Introduction" 0} What is ToolType
@{"
Shareware
" link "Shareware" 0} How to register ToolType
@{"
Requirements
" link "Requirements" 0} What you need to use ToolType
@{"
Installation
" link "Installation" 0} How to install ToolType
@{"
Using
ToolType
" link "Using_ToolType" 0} Making it work
@{"
Options
" link "Options" 0} How to configure ToolType
@{"
Author
Information
" link "Author" 0} Bugs, Suggestions, & Registering
@{"
History
" link "History" 0} What's changed
@endnode
@node "License_&_Disclaimer" "License and Disclaimer"
-+- License -+-
ToolType is being released under the concept of '@{"Shareware" link "Shareware" 0}'.
ToolType may be freely distributed as long as no charge is made other than to
cover time and copying costs. If it is to be distributed via floppy disk,
this cost should be no higher than $3.00 (three) dollars US. If distribution
is via CDRom, the total cost should be no more than Fred Fish charged from one
of his CDRom collections.
You may not copy and/or distribute this program without the accompanying
documentation unless you get permission from the author to do so.
Fred Fish and Walnut Creek have my permission to include this program on their
CDRom collections.
Finally if you wish to include ToolType on a disk magazine you are REQUIRED to
get the author's permission FIRST. Usually this will require you to just send
me a copy of the issue which contains ToolType free of charge.
-+- Disclaimer -+-
This product is sold "as is" without representation or warranty of any kind,
either expressed or implied. The user assumes all risks and responsibilities
related to its use.
@endnode
@node "Introduction" "Introduction"
What does ToolType do?
ToolType will allow you to edit tooltypes in icons using your favorite text
editor, rather than that silly string gadget intuition gives you in the
information requester
ToolType can sort the tooltypes alphabetically, placing commented icons first
or last in the sorted list.
ToolType can be set up as an appicon for on the fly tooltype editing.
ToolType will automatically comment or uncomment tooltypes for you, all you
have to do is mark tooltypes to be commented with a '(' or delete the '(' to
uncomment them.
ToolType can take a textfile with tooltypes in it and put them in an icon.
This feature is usefull if you need to add the same tooltypes to several
icons. This can easily be done by using a batch file or a 'For' command.
Users of Nicola Salmoria's NewIcon package will still be able to use ToolType
without loosing any of the palette information, newicon image or oldicon
image. These features will be available weather or not you have the NewIcons
patch running, provided you have newicons.library installed.
@endnode
@node "Shareware" "ShareWare"
PLEASE SUPPORT SHAREWARE!
ToolType is shareware, you can use all the options and features of ToolType
without any limitations. ToolType is not crippled in any manner. After an
evaluation period of 30 days, if you want to still use ToolType you are asked
to register.
The following is the current price list for ToolType.
$5.00 US.
Please see @{"Author
Info" link "Author" 0}, for information on contacting me and my address to
send in your registration
Sending in your registration fee will help ensure futhor developement of
ToolType. Also I will give priority to suggestions and questions from
register users.
Please note in the time that ToolType has be released I have received only one
registration. As this version involved a complete rewrite and I have no use
for a localized version, all locale support was removed. If I receive enough
requests/registration I would be glad to put it back.
@endnode
@node "Requirements" "Requirements"
ToolType does not require much in order to work. You will however need to
have the following items installed or available on your Amiga to use
ToolType.
1) Workbench 2.0+
2) ReqTools library (
Nico Francois) not included
3) A text editor
4) some icons.
Optional
1) NewIcon.library (
Nicola Salmoria) not included
@endnode
@node "Installation" "Installation"
Installing ToolType
~~~~~~~~~~~~~~~~~~~~~
Nothing could be easier. Just make sure you have ReqTools in libs: and place
ToolType where ever you want. If your going to use the appicon feature, I
recommend placing it in WBStartup.
@endnode
@node "Using_ToolType" "Using ToolType"
Using ToolType
**************
Using ToolType is very easy. First just make sure you have configured
ToolType to you system and liking.
You can start ToolType in any of the following ways:
1) ToolType can be started without any arguments from either Workbench or
shell. In this case you will be presented with a filerequester. Just select
the icon you wish to edit with the requester.
2) If you start ToolType with and argument, either from Workbench (via extend
selecting) or and a cli arguement from your favorite shell.
3) If you start ToolType with the AppIcon option on, ToolType will place an
appicon on your Workbench window. Now all you have to do is drop your icons
on the appicon to edit them. You can also double click on the appicon to
select icon with a file requester. If you cancel the file requester, you will
be presented with a information requester with the option to quit.
Reguardless of which method you use to start ToolType, your text editor will
be run and the tempfile created, which contains all the tooltypes, will be
loaded. Each line represents a different tooltype. Just edit the tool types
as you would any other text file. When you are done, save the changes and
ToolType will read the tempfile, extract the ToolTypes and save them to the
icon.
NOTES: Blank lines in the the text file will be ignored. A blank line is
any line which begins with a space or a carriage return.
Limitations:
1) ToolType is limited to 256 tooltypes (If you need more let me know)
2) Workbench limits tooltype lengths to 128 chars.
@endnode
@node "Options" "Options"
Options
~~~~~~~~~
Options can be specified in the tooltypes (when starting from the Workbench)
or on the command line (when starting from a Shell).
EDITOR
Command string you run your text editor. Tooltype will look in you
Workbench path to find your editor. If your editor is not located in
Workbench's path or if Workbench is not running, then you will need to
include the complete path. If your text editor runs asynchronously you
also need to specify the WAIT option. ToolType will automatically
place the name of the tempfile at the end of the command strings. If
you need this to be in the middle, put a `%s' in the command string to
specify where the name of the temporary file should be inserted.
If you do not specify this option ToolType will read the environment
variable 'ToolType' if this does not exist it will try the variable
'Editor'. If all the above fail it will default to using 'ED %s'
SORT
This options describes how you wish to handle sorting of the tooltype.
The choices are:
Ask - pop up a requester each time you edit an icon if you wish
the tooltypes to be sorted.
True - always sort the tooltypes.
False - never sort the tooltypes.
The default is Ask.
WAIT
Some text editors run asynchronously, that is they detach from the shell
when run. If your text editor does this, you need to specify this
option. When is set, a requester asking if you are done editing the
tempfile will appear. Click on it only after you have finished editing
the tempfile and have saved the changes
Default is off.
CONFIRM
If you wish to be asked if it is OK to change the tooltypes in the icon,
set this tooltype. ToolType will check the creation date of the tempfile
before it runs the text editor and again after. Only if the date
changes, will the confirmation requester appear.
Default is off.
COMMENT
When sorting the tooltypes, the commented ones those surrounded by '('
')', will be placed after the uncommented ones. Setting this option
tells ToolType to place the commented ones first not last. This
options only works if the tooltypes are being sorted.
Default to is place the commented tooltypes last.
PUBSCREEN
This option specifies name of public screen requesters should appear
on, if not specified or the name is invalid, Workbench will be used.
Default is 'Workbench'
QUIET
This option suppress the copyright notice when ToolType is started from
WorkBench.
APPICON
This option tells ToolType to add an appicon to the Workbench.
ICONX
This options lets you specify the horizontal position of the appicon.
Default is to let Workbench pick the location.
ICONY
This options lets you specify the vertical position of the appicon
Default is to let Workbench pick the location.
ICONNAME
This option lets you specify the name that should appear under the
appicon on the Workbench screen.
Default is 'ToolType'
FILE
This option is only available from the CLI. Use this option to
specify
a text file which would contain tooltypes to add to icons. ToolType
will read the text file and change the icon's tooltypes to those
specified in the text file.
@endnode
@node "Locale" "Locale"
Locale Support
**************
This feature has been removed in v3.0. If there are enough
requests/registrations I will put it back.
@endnode
@node "Author" "Author Information"
Author information
I can be reached at any of the following.
Snail mail:
Michael J Barsoom
5524 Pine Street
Omaha NE
68106
USA
E-Mail
Internet: mbars@bluejay.creighton.edu
Fidonet: Mike Barsoom @ 1:285/11.9
AmigaNet: Mike Barsoom @ 40:200/10.9
@endnode
@node "History" "History"
Release 3.1
o ToolType now supports NewIcons, provided you have newicon.library
installed.
Release 3.0a
o CONFIRM switch was not working (fixed)
o Will now look for your text editor in your Workbench path, you
no longer have to specify the whole path for editor command
string.
Release 3.0
o Found a bug which I could not figure out. So I rewrote the whole
thing. Result was an executable which what much shorter in length.
o Removed locale support, if you want it back concider registering.
o Rewrote docs, now much easier to read
Prior Versions
o Ancient history
@endnode
@node HeddleyAutoIndex "Index"
@remark Index auto-generated by Heddley
Index of database ToolType.guide
Documents
@{"Author Information" link "Author"}
@{"History" link "History"}
@{"Installation" link "Installation"}
@{"Introduction" link "Introduction"}
@{"License and Disclaimer" link "License_&_Disclaimer"}
@{"Locale" link "Locale"}
@{"Options" link "Options"}
@{"Requirements" link "Requirements"}
@{"ShareWare" link "Shareware"}
@{"ToolType documentation" link "MAIN"}
@{"Using ToolType" link "Using_ToolType"}
Buttons
Author
Information
" link "Author" 0}
History
" link "History" 0}
Installation
" link "Installation" 0}
Introduction
" link "Introduction" 0}
License
Disclaimer
" link "License_&_Disclaimer" 0}
Options
" link "Options" 0}
Requirements
" link "Requirements" 0}
Shareware
" link "Shareware" 0}
Using
ToolType
" link "Using_ToolType" 0}
@{"Author
Info" link "Author" 0}
@{"Shareware" link "Shareware" 0}
@endnode